home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / ato63a.arc / ATOADV.EXE / AUTOADV.DOC < prev   
Text File  |  1990-03-28  |  55KB  |  1,822 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                              A U T O S I G
  18.  
  19.                               Version 6.3
  20.  
  21.                       March, 1990 Manual Revision
  22.  
  23.                       A Communications Program for
  24.                           Accessing CompuServe
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.              This manual describes the advanced functions for the
  39.              ATOPPN database processor, the ATO script language,
  40.              and ACLS Accounting Log Summary components of AUTOSIG.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.              AUTOSIG Version 6.3 -  March, 1990
  58.              (c) Copyright 1985-90 by Vernon D. Buerg
  59.  
  60.             T A B L E   O F   C O N T E N T S
  61.  
  62. __________________________________________________________________________
  63.  
  64.  Introduction  ......................................................... 1
  65.  
  66.  I.   ATOPPN - ATO Address Book  ....................................... 2
  67.       ATOPPN Menu  ..................................................... 3
  68.       Address Book Commands  ........................................... 4
  69.         A  Add manual entry  ........................................... 4
  70.         B  Switch PPN database file  ................................... 4
  71.         C  Change current entry  ....................................... 4
  72.         D  Delete current entry  ....................................... 4
  73.         E  Erase PPN file  ............................................. 4
  74.         F  Find name or userid  ........................................ 4
  75.         M  Switch message file  ........................................ 5
  76.         L  sort by Last name  .......................................... 5
  77.         N  sort by Name  ............................................... 5
  78.         P  Put entry to TO: field  ..................................... 5
  79.         R  Repeat Find to next  ........................................ 5
  80.         S  Sort by userid/ppn  ......................................... 5
  81.         U  Update file from msgs  ...................................... 6
  82.         Q  Quit, return to ATO  ........................................ 6
  83.         ESC  Abort, return to ATO without updating  .................... 6
  84.  
  85.  II.  ATOSCR - Script File Processing  ................................. 7
  86.       Statement syntax  ................................................ 8
  87.       Summary of Verbs  ................................................ 13
  88.       Examples  ........................................................ 14
  89.         Example 1.  .................................................... 14
  90.         Example 2.  .................................................... 14
  91.         Example 3.  .................................................... 15
  92.         Example 4.  .................................................... 15
  93.         Example 5.  .................................................... 16
  94.         Example 6.  .................................................... 16
  95.         Example 7.  .................................................... 17
  96.         Example 8.  .................................................... 18
  97.         Example 9.  .................................................... 19
  98.       Global symbols  .................................................. 20
  99.         %HOST variables  ............................................... 20
  100.         %SIG variables  ................................................ 20
  101.         %PC variables  ................................................. 21
  102.         %SW Command line variables  .................................... 21
  103.         Other global variables  ........................................ 22
  104.  
  105.  III. ACLS - Accounting Log Summary  ................................... 23
  106.       Log Files  ....................................................... 23
  107.       Running ACLS  .................................................... 24
  108.       Figure 1.  ACLS Accounting Summary  .............................. 25
  109.       Figure 2.  RATES.ATO sample data  ................................ 25
  110.       Figure 3.  ACLS Rates and Definitions  ........................... 25
  111.       Figure 4.  ACLS Sample Output  ................................... 26
  112.  
  113.   Appendices  .......................................................... 27
  114.       Disclaimer  ...................................................... 27
  115.       Copying and sharing AUTOSIG.  .................................... 27
  116.       Using Virtual Disks  ............................................. 28
  117.  
  118.  
  119. Contents 1                                    AUTOSIG Advanced Functions Guide
  120. Introduction
  121. ______________________________________________________________________________
  122.  
  123.  
  124.     AUTOSIG  is  a  program  written  specifically  for  CompuServe  Special
  125.     Interest Group access.  It provides  an automatic way of processing  SIG
  126.     messages that is quick and economical.
  127.  
  128.  
  129.     AUTOSIG is a  FREE communications program  written with Quick  Basic and
  130.     assembly language.  It  is provided as  a executable (.EXE)  program for
  131.     the IBM PC. It is fully compatible with Compaq computers, the Tandy 1000
  132.     and 1200, and  most other clones.   In addition to  its main purpose  of
  133.     offloading  messages,  it  is  a  terminal  program which can be used to
  134.     access other areas  of CompuServe and  download from the  Data Libraries
  135.     using "B" protocol.
  136.  
  137.  
  138.     This manual discusses three advanced features of AUTOSIG:
  139.  
  140.     1 - the PPN database processor for keeping an address book
  141.  
  142.     2 - the script processor used to execute a stored series of ATO commands
  143.  
  144.     3 - the ACLS accounting log summary report program
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178. Page  1                                                 AUTOSIG User's Manual
  179. I.   ATOPPN - ATO Address Book
  180. ______________________________________________________________________________
  181.  
  182.  
  183. |   ATOPPN allows you to maintain your own local address book of up to  2000
  184. |   user names  and IDs.  Using ATOPPN  makes finding  people's names and ID
  185. |   numbers easy.  About  340K  of available  memory is required to  run ATO
  186. |   with the ATOPPN database.
  187.  
  188.     ATOPPN is one of those features that's much easier to use than it is  to
  189.     explain, so  here's a  short summary  of functions.   After getting  the
  190.     "flavor" of ATOPPN your best bet is to go for it.
  191.  
  192.     ATOPPN is  invoked by  using the  alt-M command  at the  Main Menu, at a
  193.     R>ead prompt, or at the To: prompt when W>riting messages.
  194.  
  195. |   The name of  the ATOPPN  database  file  is  defined  in  the  ATO Forum
  196. |   Options menu.  The default is AUTOSIG.PPN.  You may  have more  than one
  197. |   ATOPPN databse file.
  198.  
  199.     The display consists of a command menu and a list of user IDs and names.
  200.     You  may  enter  a  letter  to  invoke  a  function,  or  press a cursor
  201.     positioning key to scroll the display of user IDs and names.  The cursor
  202.     positioning keys are:
  203.  
  204.              HOME       - position to the first PPN entry
  205.              END        - position to the last PPN entry
  206.              down arrow - position to the next entry
  207.              up arrow   - position to the previous entry
  208.              PgUp       - move back 20 entries
  209.              PgDn       - move ahead 20 entries
  210.  
  211.  
  212.     The "current" entry is shown in  two places: on the left side  above the
  213.     command menu, and  highighted in the  list of PPNs.   This is the  entry
  214.     that is the subject of any  Change or Delete commands, and of  the Paste
  215.     command.
  216.  
  217.     You may  exit the  program by  using the  Q command  to save changes and
  218.     quit, or the ESCape command to not save any changes and abort.
  219.  
  220.  
  221.     The display  gives you  the name  of the  PPN file  and of  a file which
  222.     contains downloaded CompuServe  messages.  You may  change the PPN  file
  223.     name with the B command, or the message file name with the X command.
  224.  
  225.  
  226.     The PPN file contains ASCII records,  one for each user ID. Each  record
  227.     ends with a carriage return (CR) and line feed (LF).  The user ID begins
  228.     in column 1 and ends in column 10.  The name begins in column 12 and may
  229. |   be up to 24 characters long.  A user ID  must be of  the form  7xxx,xxxx
  230. |   where the x may be a number from 0 to 7.
  231.  
  232.     The ATOPPN menu appears as follows:
  233.  
  234.  
  235.  
  236.  
  237. AUTOSIG User's Manual                                                 Page  2
  238. I.   ATOPPN - ATO Address Book
  239. ______________________________________________________________________________
  240.  
  241.  
  242.  ATOPPN Menu
  243.  
  244.  
  245.  
  246.      +--------------------------+            +--------------------------+
  247.      |   AUTOSIG PPN Database   |        0   |       AUTOSIG.PPN        |
  248. +------------------------------------+ +--------------------------------------+
  249. |  A - Add a manual entry            | |                                      |
  250. |  B - switch PPN database file      | |                                      |
  251. |  C - Change current entry          | |                                      |
  252. |  D - Delete current entry          | |                                      |
  253. |  E - Erase PPN file                | |                                      |
  254. |  F - Find name or userid           | |                                      |
  255. |  M - switch Message file           | |                                      |
  256. |  L - sort by Last name             | |                                      |
  257. |  N - sort by Name                  | |                                      |
  258. |  P - Put entry in TO: field        | |                                      |
  259. |  R - Repeat Find to next           | |                                      |
  260. |  S - Sort by userid/ppn            | |                                      |
  261. |  U - Update file from msgs         | |                                      |
  262. |  Q - Quit, return to ATO           | |                                      |
  263. +------------------------------------+ |                                      |
  264.    _   Select a letter                 |                                      |
  265.                                        |                                      |
  266.                                        |                                      |
  267.  Msg file: IBMCOMM.ATO                 |                                      |
  268.                                        |                                      |
  269.                                        +--------------------------------------+
  270.  Use ESCape to abort, no updates        Use cursor keys to scroll display   0
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296. Page  3                                                 AUTOSIG User's Manual
  297. I.   ATOPPN - ATO Address Book
  298. ______________________________________________________________________________
  299.  
  300.  Address Book Commands
  301.  
  302.  
  303.    A  Add manual entry
  304.  
  305.     You are asked to enter a new  user ID (PPN) and name.  The user  ID must
  306.     be  two  numbers  separated  by  a  comma.   The  name  may  be up to 24
  307.     characters long.  Follow the CIS convention.  The new entry is added  to
  308.     the end of the file.  For example, you could enter
  309.  
  310.                         Their name first 70000,0000
  311.  
  312. |   User IDs may also be added while  R)eading messages  with ATO.  When you
  313. |   use the Alt-I command to insert a PPN, that entry is added to the end of
  314. |   the ATOPPN database.  When ATOPPN is invoked,  you are  prompted whether
  315. |   or not you want to add the inserted user ID.
  316.  
  317.  
  318.    B  Switch PPN database file
  319.  
  320.     You are asked to enter the name of the PPN file you want displayed.  You
  321.     may include a drive and/or path name.  For example, C:\ATO\IBMCOM.PPN is
  322.     acceptable.
  323.  
  324.  
  325.  
  326.    C  Change current entry
  327.  
  328.     You are prompted to supply  new name information for the  current entry.
  329.     You can not change the PPN number.
  330.  
  331.  
  332.  
  333.    D  Delete current entry
  334.  
  335.     The highlighted current  entry is deleted.   The next entry  becomes the
  336.     new current entry.
  337.  
  338.  
  339.  
  340.    E  Erase PPN file
  341.  
  342.     You are prompted to verify that you want to delete the PPN file, and may
  343.     reply with Y to delete the file, or N to keep the file.
  344.  
  345.  
  346.  
  347.    F  Find name or userid
  348.  
  349.     You are prompted for  a text string.  ATOPPN  searches the PPN file  for
  350.     that text.  The search is case insensitive.  If the text is found in  an
  351.     entry, that entry is made the current entry.
  352.  
  353.  
  354.  
  355. AUTOSIG User's Manual                                                 Page  4
  356. I.   ATOPPN - ATO Address Book
  357. ______________________________________________________________________________
  358.  
  359.  Address Book Commands
  360.  
  361.  
  362.    M  Switch message file
  363.  
  364. |   You are presented with a menu of forum names.  Type in the letter for
  365. |   the forum message file that you wish to use. Alternatively, you may type
  366. |   in a file name that  represents a file of  downloaded CIS messages.  You
  367.     may include  a drive and/or path name.   For example, C:\ATO\IBMCOMM.ATO
  368.     is acceptable.
  369.  
  370.  
  371.    L  sort by Last name
  372.  
  373.     The PPN file is  sorted by ascending order  of user last names.   Middle
  374.     initials are ignored but title, like [SuperForum] may obscure the sort.
  375.  
  376.  
  377.  
  378.    N  sort by Name
  379.  
  380.     The PPN file  is sorted by  user name in  ascending order.  The  sort is
  381.     case insensitive.  That is, the  names "bill" and "BILL" are  treated as
  382.     the same name.
  383.  
  384.  
  385.  
  386.    P  Put entry to TO: field
  387.  
  388.     The user name and ID are returned to the calling program.  For  AUTOSIG,
  389.     this information  is copied  to the  "To:" field  in the message editor.
  390.     Otherwise,  the  information  is  displayed  on  the console.  For EMAIL
  391.     messages, only the ID (ppn) is copied.
  392.  
  393.  
  394.  
  395.    R  Repeat Find to next
  396.  
  397.     Used after  a successful  Find command,  the R  command searches for the
  398.     next occurrance of the text in the PPN file.
  399.  
  400.  
  401.  
  402.    S  Sort by userid/ppn
  403.  
  404.     The PPN file is sorted by user ID (PPN) in ascending order.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414. Page  5                                                 AUTOSIG User's Manual
  415. I.   ATOPPN - ATO Address Book
  416. ______________________________________________________________________________
  417.  
  418.  Address Book Commands
  419.  
  420.  
  421.    U  Update file from msgs
  422.  
  423.     ATOPPN scans the CIS message file for message headers.  It then extracts
  424.     the  user  names  and  IDs  from  the  "Fm:" line.  When a new userid is
  425.     encountered, you are given the prompt:
  426.  
  427.            Add 7xxxx,xxxx new user
  428.            Y>es, n>o, s>top asking, q>quit?
  429.  
  430.     Respond with a Y to add the new userid, an N to bypass , an S to add the
  431.     userid and stop asking each time a new userid is encountered, or with  a
  432. |   Q to stop processing the message file.  Duplicate  userids  are added if
  433. |   the name is different.
  434.  
  435.  
  436.  
  437.    Q  Quit, return to ATO
  438.  
  439.     You are returned to  ATO, and if any  changes were made the  PPN file is
  440.     re-written.
  441.  
  442.  
  443.    ESC  Abort, return to ATO without updating
  444.     You are  returned to  ATO and  no updates  are processed.   The PPN file
  445.     remains unchanged.
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473. AUTOSIG User's Manual                                                 Page  6
  474. II.  ATOSCR - Script File Processing
  475. ______________________________________________________________________________
  476.  
  477.  
  478.     ATO can execute commands  from a script file.   Scripts are a series  of
  479.     user coded statements contained within a file.  You execute a script  by
  480.     issuing the alt-T command while in Terminal Mode.  Or, you may specify a
  481.     special logon script in each Host entry.  Or, you may supply the name of
  482.     the script on the command line for starting ATO using the /X  parameter.
  483.     For example:
  484.  
  485.                         AUTOSIG /Xdostuff.scr
  486.  
  487.     A script ends when the last statement has been processed, you press  the
  488. |   ESCape key, or if an error is detected.  The current limit is  200 lines
  489. |   in a script file, and 150 different symbols.
  490.  
  491.     You may also enter one script command at the terminal by using the alt-I
  492.     keys.
  493.  
  494.  
  495.     Script statements have the following syntax:
  496.  
  497.                 verb  [operand1 operand2 ... operandn]
  498.  
  499.     You must  separate the  verb and  operands by  one or  more blanks.  For
  500.     example:
  501.  
  502.                 UPL funtim.arc /type:ascii/prot:b|c:\save\funtime.arc
  503.  
  504.     Operands  consist  of  one  or  more  symbol names, and/or literal data.
  505.     Symbols are either global  system variables, or user  defined variables.
  506.     The names may be of any  length and may contain any characters  except a
  507.     space or a single quote.  Global names are listed below.  User names can
  508.     be any name except that of  a global varable.  Literal data is  a string
  509.     of characters enclosed  within single quotes.   Quotes are not  required
  510.     unless the literal string contains the  name of a symbol, a space,  or a
  511.     comma.
  512.  
  513.     For  example,  %HOSTsymbol  is  a  global  variable,  %XZ  may be a user
  514.     variable, and 'hello there' is literal text data.
  515.  
  516.  
  517.     If the operand is [data], you  may supply a list of symbol  names and/or
  518.     literal values.  They are combined into one value.
  519.  
  520.  
  521.     While scripts are  being processed, COM  data may be  received.  The COM
  522.     data is not processed until a READ, WAIT of MATCH verb is executed.  The
  523.     last line of COM data is  available in the global variable called  %COM.
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. Page  7                                                 AUTOSIG User's Manual
  533. II.  ATOSCR - Script File Processing
  534. ______________________________________________________________________________
  535.  
  536.  Statement syntax
  537.  
  538.  
  539.   Verb:     * [comment]
  540.   Function: Provide  user comments or remarks Usage: The statement is ignored.
  541.  
  542.  
  543.   Verb:     label: [statements]
  544.   Function: Name a statment for branching purposes.
  545.   Usage:    Performs the same function as the LABEL verb.
  546.  
  547.  
  548.   Verb:     ACCEPT symbol
  549.   Function: Read data from the console into a variable.
  550.   Usage:    If 'symbol' is not currently defined, it becomes defined.
  551.             Unless otherwise noted, global symbols may not be modified.
  552.  
  553.  
  554.   Verb:     BEEP
  555.   Function: Sound the computer's horn. The ATO beep toggle status is
  556.             not used.
  557.  
  558.  
  559.   Verb:     CAPTURE [OFF|ON|filename]
  560.   Function: Open or close a capture file.
  561.   Usage:    To open a capture file, specify a file name the first time.
  562.             After closing the capture file, you may re-open it with the
  563.             same file name by specifying ON. All received data, except for
  564.             protocol file transfer data, is written to the end of the capture
  565.             file. For example,
  566.  
  567.                 CAPTURE FORUM.LOG
  568.                 ... do some stuff ...
  569.                 CAPTURE OFF
  570.                 ... do some more stuff ...
  571.                 CAPTURE ON
  572.                 ... writing to FORUM.LOG again ...
  573.  
  574.  
  575.   Verb:     CLOSE filenumber
  576.   Function: Disconnect access to the file associated with filenumber.
  577.  
  578.  
  579.   Verb:     CLS
  580.   Function: Clear the screen.
  581.  
  582.  
  583.   Verb:     DISPLAY [data]
  584.   Function: Writes data to the current display monitor.
  585.   Usage:    The 'data' value may be a list of symbol names, and/or literal
  586.             strings.
  587.  
  588.  
  589.  
  590.  
  591. AUTOSIG User's Manual                                                 Page  8
  592. II.  ATOSCR - Script File Processing
  593. ______________________________________________________________________________
  594.  
  595.  Statement syntax
  596.  
  597.   Verb:     DOW filename
  598.   Function: Invokes CIS-QB protocol to download the specified file. The
  599.             file is placed in the drive\path defined by the Host entry.
  600. |           The [7xxxx,xxxx] user ID after the filename is optional.
  601.  
  602.  
  603.   Verb:     ELSE [statement]
  604.   Function: Process [statement] only when the IF condition is false.
  605.  
  606.  
  607.   Verb:     EXIT  [code]
  608.   Function: Terminate processing of the current script file, and
  609.             if supplied, perform the 'code' function. The code may be
  610.             any single character that is acceptable at the main ATO menu
  611.             prompt, such as Z to logoff, or 1 to run AUTO /1, etc.
  612.  
  613.   Verb:     GOTO label
  614.   Function: Transfer script processing to the LABEL statement with the
  615.             identity of 'label'.
  616.  
  617.  
  618.   Verb:     IF var1 var2 [statement]
  619.   Function: Set the condition code based on contents of 'var1' and 'var2'
  620.   Usage:    The condition is set to TRUE if 'var2' occurs within the
  621.             'var1' variable, not if they are exactly equal. You can use the
  622.             global and local symbols as var1 and/or var2. For example, you
  623.             can use %COM to determine if some data occurs in the communications
  624.             buffer, e.g. IF %COM 'NO CARRIER' THEN DISPLAY 'Gone fishing!'.
  625.  
  626.             The optional [statement] is executed when the condition is true.
  627.             Both 'var1' and 'var2' are required. The special %EOF variables
  628.             have either a null value or the value 'EOF'.
  629.  
  630.  
  631.   Verb:     LABEL labelname
  632.   Function: Identify a statement for branching purposes.
  633.   Usage:    There is no checking for duplicate labels. The first occurance
  634.             of the label name is used by script verbs, e.g. GOTO. Labels can
  635.             also be entered in the form "label:", where the colon after
  636.             the label name identifies the script statement for use by GOTO.
  637.             For example:
  638.  
  639.                 LABEL LOOP
  640.                 Display "Hello"
  641.                    -or-
  642.                 LOOP: Display "Hello"
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650. Page  9                                                 AUTOSIG User's Manual
  651. II.  ATOSCR - Script File Processing
  652. ______________________________________________________________________________
  653.  
  654.  Statement syntax
  655.  
  656.   Verb:     LOGON
  657.   Function: If necessary, sends dialing commands to the modem, and
  658.             connects to the selected Host; it then issues a Go Page
  659.             to the selected Forum. If ATO is already online and in
  660. |           the selected Forum, no action is taken. If the Host or
  661. |           forum is not valid, the script is terminated.
  662.  
  663.  
  664.   Verb:     LOGOFF -or- OFF
  665.   Function: Performs the Z (logoff) function by sending an OFF to CIS
  666.             and then hanging up the phone.
  667.  
  668.  
  669.   Verb:     MATCH  data
  670.   Function: Causes processing to stop until the 'data' is received
  671.             from the communications line. The 'data' can be a simple
  672.             literal text string, or a combination of literal and
  673.             symbolic values. You can interrupt MATCH by pressing the
  674.             ESCape key. You can not include ^J or ^M in the MATCH text.
  675.             MATCH is different from WAIT in that the MATCH [data] is
  676.             expanded (resolved) for any user symbols.
  677.  
  678. |           You may specify two search texts in the 'data' argument by
  679. |           separating them with a | symbol. For example, ABC|DEF will
  680. |           search for ABC or DEF.
  681.  
  682.  
  683.   Verb:     OPEN filename filenumber mode
  684.   Function: Initialize access to a file for READ and WRITE use. The
  685.             filename may include drive and space. The filenumber must
  686.             be value from 0 through 9, determined by you. The 'mode'
  687.             must be INPUT, OUTPUT or APPEND.
  688.  
  689.  
  690.   Verb:     PAUSE [number]
  691.   Function: Suspend processing for 'number' of seconds.
  692.   Usage:    If the 'number' is omitted, a one second pause results.
  693.  
  694.  
  695.   Verb:     READ  [filenumber] [symbol]
  696.                         -or-
  697.             READLINE  [filenumber] [symbol]
  698.   Function: Get data from the specified file and place it into the local
  699.             symbol. If [filenumber] is omitted, the communications buffer
  700.             is assumed. If [symbol] is omitted, %COM is assumed.
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709. AUTOSIG User's Manual                                                 Page  10
  710. II.  ATOSCR - Script File Processing
  711. ______________________________________________________________________________
  712.  
  713.  Statement syntax
  714.  
  715.   Verb:     SEND  [data]
  716.   Function: Write data to the COM port
  717.   Usage:    The data may be a list of symbol names and literal strings.
  718.             All data fields are combined into one string and sent to the
  719.             COM port. Control characters may be entered by using the carat
  720.             symbol (^) followed by a control character letter. For example,
  721.             a ^M will result in a carriage return (CR) being sent. A pause
  722.             may be embedded in any data string by entering a squiggle (~)
  723.             character.
  724.  
  725.   Verb:     SENDLINE [data]
  726.   Function: Write a line of data to the COM port.
  727.   Usage:    Similar to SEND except that a carriage return ^M is appended
  728.             to the [data].
  729.  
  730.  
  731.   Verb:     SET symbol data
  732.   Function: Assign a value to a symbol.
  733.   Usage:    Unless noted below, values can not be assigned to global
  734.             symbols. User symbols become defined when they are referenced
  735.             by a SET statement.  The 'data' may be a list of symbol names
  736.             and/or literal data. For example,
  737.                 SET x 'hello'
  738.                 SET y x
  739.             results in the symbol y having the value 'hello'.
  740.  
  741. |           Some global symbols may also be changed with SET. For example,
  742. |               SET %SWD Y
  743. |           turns on the /D carrier detect over-ride option so that you
  744. |           may place ATO online even though ATO can't detect carrier.
  745.  
  746.   Verb:     SHELL dos-command-text
  747.   Function: Invoke a DOS command or other program.
  748.  
  749.  
  750.   Verb:     SHOW [symbol]
  751.   Function: Display one or all defined symbols.
  752.   Example:  SHOW %SWD will result in a display of the %SWD value, Y or N.
  753.  
  754.  
  755.   Verb:     THEN [statement]
  756.   Function: Process [statement] only when the IF condition is true.
  757.  
  758.  
  759.   Verb:     TRACE [ON|OFF]
  760.   Function: Enable or disable tracing of the script statements. If TRACE
  761.             is ON, all script statements are displayed before they  are
  762.             executed.
  763.  
  764.  
  765.  
  766.  
  767.  
  768. Page  11                                                 AUTOSIG User's Manual
  769. II.  ATOSCR - Script File Processing
  770. ______________________________________________________________________________
  771.  
  772.  Statement syntax
  773.  
  774.   Verb:     UPL cisfilename[|yourfilename]
  775.   Function: Invokes CIS-QB protocol to upload the specified file. You may
  776.             include drive\path with the file name.  Since CIS allows only
  777.             six characters in the filename, you may supply both the CIS
  778.             file name and your computer's file name. Separate the CIS and
  779.             your filename with a | character, for example:
  780.  
  781.             UPL MYPROG.ARC /prot:b/type:bin| C:\TESTBED\NEWVERSN.ARC
  782.  
  783.             When you supply both names, using the | character, you must
  784.             also supply the /prot: and /type: parameters for CIS.  You can
  785.             take advantage of this syntax to upload ASCII files, since the
  786.             default type for uploads is BINary.
  787.  
  788.  
  789.   Verb:     WAIT  [text]
  790.   Function: Suspend processing until the data is received from the COM
  791.             communications line.
  792.   Usage:    Checking is performed for lost carrier and the modem return
  793.             messages for NO CARRIER, etc. If a disconnect if detected,
  794.             the script is terminated. Execution of the script resumes when
  795.             the [data] is received by the communications line. Unlike MATCH,
  796.             there is no expansion of symbols. The [text] is used as-is.
  797.  
  798.  
  799.  
  800.   Verb:     WRITE [filenumber] [symbol]
  801.   Function: Place the data contained in the [symbol] local variable into
  802.             the file associated with [filenumber].
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827. AUTOSIG User's Manual                                                 Page  12
  828. II.  ATOSCR - Script File Processing
  829. ______________________________________________________________________________
  830.  
  831.  Summary of Verbs
  832.  
  833.  
  834.  
  835.         Notation:
  836.                 [] brackets identify optional parameters
  837.                 |  indicates an exclusive choice
  838.                 data  means a string of literal and/or symbol values
  839.                 text  means a string of literal values
  840.  
  841.         ----------------------------------------------------------------
  842.  
  843.         * [comment]                           SEND  [data]
  844.                                               SENDLINE [data]
  845.         label: [statements]                   SET symbol data
  846.                                               SHELL dos-command-text
  847.         ACCEPT symbol                         SHOW [symbol]
  848.  
  849.         BEEP                                  THEN [statement]
  850.                                               TRACE [ON|OFF]
  851.         CAPTURE [ON|OFF|filename]
  852.         CLOSE filenumber                      UPL cisfilename[options|yourfilename]
  853.         CLS
  854.                                               WAIT  text
  855.         DISPLAY [data]                        WRITE filenumber symbol
  856.         DOW filename[ppn]
  857.  
  858.         ELSE [statement]
  859.         EXIT [code]
  860.  
  861.         GOTO labelname
  862.  
  863.         IF var1 var2 [statement]
  864.  
  865.         LABEL labelname
  866.         LOGOFF
  867.         LOGON [host forum]|[forum]
  868.  
  869.         MATCH data
  870.  
  871.         OFF
  872.         OPEN filename filenumber mode
  873.  
  874.         PAUSE [number]
  875.  
  876.         READ  [filenumber] [symbol]
  877. |       READLINE  [filenumber] [symbol]
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886. Page  13                                                 AUTOSIG User's Manual
  887. II.  ATOSCR - Script File Processing
  888. ______________________________________________________________________________
  889.  
  890.  Examples
  891.  
  892.  
  893.    Example 1.
  894.     Demonstrate the use of IF, THEN, and ELSE
  895.  
  896.           sendline
  897.         label again
  898.           read
  899.           if %COM 'Function:' then goto ready
  900.            else display 'not yet'
  901.           goto again
  902.         label ready
  903.            beep
  904.            display 'What time is it?'
  905.            accept tod
  906.            exit
  907.  
  908.     The 'IF' verb  does not require  a statement.  You  can place any  valid
  909.     statment after the  IF, and/or can  use the THEN  and ELSE verbs  later.
  910.     The IF condition remains valid until  the next IF is executed.  IF  does
  911.     require at least two parameters; the 'var1' and var2' values.
  912.  
  913.  
  914.    Example 2.
  915.     Demonstrate the use of SEND, WAIT, and literal strings.
  916.  
  917.         trace on
  918.         Send 'go ' ibmcom^M
  919.         Wait Function:
  920.         Send 'ust^M'
  921.        label loop
  922.         If 'Function:' Goto Ready
  923.         Read
  924.         Goto loop
  925.        label ready
  926.         display 'Ready to proceed...'
  927.         beep
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945. AUTOSIG User's Manual                                                 Page  14
  946. II.  ATOSCR - Script File Processing
  947. ______________________________________________________________________________
  948.  
  949.  Examples
  950.  
  951.  
  952.    Example 3.
  953.     Demonstrate use of global variables
  954.  
  955.          * Use the current HOST and SIG selections to log on
  956.          send ATDT %HOSTPHONE ^M
  957.          match CONNECT
  958.          pause 4
  959.          send '^C'
  960.          match User ID:
  961.          display '{' %COM '}'
  962.          send %HOSTUSERID ^M
  963.          if %hostuserid '\' then goto have.pswd
  964.           match Password:
  965.           send %HOSTPASSWORD '^M'
  966.         label have.pswd
  967.          match OK
  968.          send 'GO ' %SIGPAGE
  969.          match 'Function:'
  970.          set savecolor %PCNORMAL
  971.          set %PCNORMAL '15,2'
  972.          display 'The current high message number is:' %SIGHMN
  973.          set %PCNORMAL savecolor
  974.          beep
  975.          display 'Ready when you are ...'
  976.  
  977.  
  978.  
  979.    Example 4.
  980.     Logon via Tymnet
  981.  
  982.         * wait for 300 baud terminal id request
  983.         pause 3
  984.         * use tty terminal id
  985.         send a
  986.         * wait for "please log in:" prompt
  987.         match in:
  988.         * make sure we have a user id
  989.         if %HOSTACCOUNT '' set %HOSTACCOUNT 'CIS02'
  990.         sendline %HOSTACCOUNT
  991.         * we made it!
  992.         *
  993.         display 'Logon to TYMNET successful'
  994.         beep
  995.         * ATO continues the logon from the User ID: prompt
  996.         exit
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004. Page  15                                                 AUTOSIG User's Manual
  1005. II.  ATOSCR - Script File Processing
  1006. ______________________________________________________________________________
  1007.  
  1008.  Examples
  1009.  
  1010.  
  1011.    Example 5.
  1012.     Logon via Telenet
  1013.  
  1014.         * wait for line to settle
  1015.         pause 3
  1016.         * send baud code or c/r depending on baud rate
  1017.         if %HOSTBAUD '2400' Send '@~^M~~'
  1018.         Else Send '^M^M'
  1019.         * wait for "TERMINAL=" prompt
  1020.         match 'TERMINAL='
  1021.         send D1^M
  1022.         * clear the COM buffer up to where we should be
  1023.         match 'D1'
  1024.         * wait for "@" net prompt
  1025.         match @
  1026.         send 'C 202202' ^M
  1027.         * we made it!
  1028.         *
  1029.         display
  1030.         display 'Logon to Telenet successful!'
  1031.         beep
  1032.         exit
  1033.  
  1034.  
  1035.  
  1036.    Example 6.
  1037.     Demonstrate use of Open, Write, Close
  1038.  
  1039.         open bulletin.ato 5 input
  1040.   loop: read 5 text
  1041.         if %EOF5 EOF then goto done
  1042.         display text
  1043.         goto loop
  1044.         label done
  1045.         close 5
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063. AUTOSIG User's Manual                                                 Page  16
  1064. II.  ATOSCR - Script File Processing
  1065. ______________________________________________________________________________
  1066.  
  1067.  Examples
  1068.  
  1069.  
  1070.    Example 7.
  1071.     DATAPAC logon and reset of PAD parameters for binary transfers
  1072.  
  1073.     *  Begin script.  Tell Datapac that this is 1200 baud  (note change the
  1074.     *  ".." to a single period "." for 300 baud)
  1075.     SEND '..^M'
  1076.     *
  1077.     *  Wait for DATAPAC acknowledgement before continuing
  1078.        WAIT DATAPAC:
  1079.        READ
  1080.        PAUSE 2
  1081.     *
  1082.     *  Request a direct DATAPAC to CIS connection
  1083.        SEND 'P 29400138^M'
  1084.     *
  1085.     *  Wait for CIS Host response
  1086.        WAIT Name:
  1087.        SEND 'CIS^M'
  1088.     *
  1089.     *  Wait for CIS User ID prompt
  1090.        WAIT ID:
  1091.        PAUSE 2
  1092.     *
  1093.     *  Enter DATAPAC command mode by sending ^P to DATAPAC and beginning the
  1094.     *  PAD changes
  1095.        SEND '^PPROF 1^M'
  1096.        PAUSE 2
  1097.     *
  1098.     *  Check the parameters of PROF1
  1099.        SEND 'PAR^M'
  1100.        WAIT 126:016
  1101.        PAUSE 2
  1102.     *
  1103.     *  Reset the PAD parameters
  1104.        SEND 'SET?002:001,126:004,003:000,004:004,007:008,020:032,001:000^M'
  1105.        WAIT 001:000
  1106.        PAUSE 2
  1107.     *
  1108.     *  Double check that the PAD was correctly modified
  1109.        SEND 'PAR^M'
  1110.        WAIT 126:004
  1111.        PAUSE 2
  1112.     *
  1113.     *  Exit DATAPAC command mode and re-enter CIS
  1114.        SEND '^M'
  1115.        PAUSE 2
  1116.        SEND '^M'
  1117.        BEEP
  1118.        EXIT
  1119.  
  1120.  
  1121.  
  1122. Page  17                                                 AUTOSIG User's Manual
  1123. II.  ATOSCR - Script File Processing
  1124. ______________________________________________________________________________
  1125.  
  1126.  Examples
  1127.  
  1128.  
  1129.    Example 8.
  1130.     Template for automatic ATO uploading
  1131.  
  1132.    * Get to forum and DL
  1133.  
  1134.      logon CIS2400 IBMCOM
  1135.      send 'DL0'^M
  1136.      match DL 0 !
  1137.  
  1138.    * Upload the file
  1139.  
  1140.      upl c:\test\upl.scr
  1141.  
  1142.    * Upload the description
  1143.  
  1144.      match Description
  1145.      match ):
  1146.      send 'Template for generating script files to automatically upload'^M
  1147.      pause 2
  1148.      send 'files using ATO.'^M
  1149.      pause 2
  1150.      send ^M
  1151.  
  1152.    * Upload the keywords
  1153.  
  1154.      match Keywords:
  1155.      send 'ATO TESTING' ^M
  1156.      match (Y or N)?
  1157.      send Y^M
  1158.  
  1159.      beep
  1160.      display 'Upload is complete!'
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181. AUTOSIG User's Manual                                                 Page  18
  1182. II.  ATOSCR - Script File Processing
  1183. ______________________________________________________________________________
  1184.  
  1185.  Examples
  1186.  
  1187.  
  1188.    Example 9.
  1189.     Script to set up a new forum for ATO
  1190.  
  1191.     * at the forum "Enter choice !" prompt,
  1192.     * use Alt-T to run the SETUP.SCR script
  1193.  
  1194.     sendline op
  1195.     match !
  1196.     sendline pause
  1197.     match :
  1198.     sendline n
  1199.     match !
  1200.     sendline editor
  1201.     match :
  1202.     sendline edit
  1203.     match !
  1204.     sendline 2
  1205.     match :
  1206.     sendline command
  1207.     match !
  1208.     sendline pc
  1209.     match prompt:
  1210.     sendline ^G
  1211.     match !^G
  1212.     sendline
  1213.     match ?
  1214.     sendline p
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240. Page  19                                                 AUTOSIG User's Manual
  1241. II.  ATOSCR - Script File Processing
  1242. ______________________________________________________________________________
  1243.  
  1244.  Global symbols
  1245.  
  1246.  
  1247.     Global  symbols  contain  data  from  the  HOST,  FORUM,  and PC OPTIONS
  1248.     definitions.   The  HOST  and  FORUM  variables  are  read-only.  The PC
  1249.     Options variables may be changed by the SET script command.
  1250.  
  1251.     The HOST menu symbols have a name of the form '%HOSTname'.
  1252.  
  1253.     The FORUM menu symbols have a name of the form '%SIGname'.
  1254.  
  1255.     The PC Options symbols have a name of the form '%PCname'
  1256.  
  1257.  
  1258.  
  1259.    %HOST variables
  1260.         From Host options menu, read-only
  1261.  
  1262.         Symbol name Default value        Symbol name Default value
  1263.         ----------- -------------------- ----------- --------------------
  1264.         NAME        host's name          PATH        default ATO d:\path
  1265.         PHONE       telephone number     COM         communications port
  1266.         USERID      your user id         CONNECT     modem connect response
  1267.         PASSWORD    your password        DISCON      modem disconnect response
  1268.         ACCOUNT     Tymnet host          HANGUP      modem commands to hang up
  1269.         CODE                             RESET       modem commands to reset
  1270.         UPROMPT     Userid: prompt       RPROMPT1    CIS logon message 1
  1271.         PPROMPT     Passsword: prompt    RPROMPT2    CIS logon message 2
  1272.         BAUD        baud rate            BULLETIN    bulletins file name
  1273.         MDMCMDS     modem commands       ANSWER      response to CONNECT
  1274.         PATH        file xfer d:\path
  1275.  
  1276.  
  1277.  
  1278.  
  1279.    %SIG variables
  1280.         From Forum Options menu, read-only.
  1281.  
  1282.         Symbol name Default value          Symbol name Default value
  1283.         ----------- --------------------   ----------- --------------------
  1284.         NAME        forum name             LOG         logging option, y/n
  1285.         PAGE        go page                STAY        stay connected option
  1286.         HOST        host name              SENDP       send ^P option, y/n
  1287.         DRIVE       default d:\path        SECS        section numbers list
  1288.         HMN         high message number    PPN         PPN d:\path\filename
  1289.         APPEND      append option, y/n
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299. AUTOSIG User's Manual                                                 Page  20
  1300. II.  ATOSCR - Script File Processing
  1301. ______________________________________________________________________________
  1302.  
  1303.  Global symbols
  1304.  
  1305.  
  1306.    %PC variables
  1307.         From PC Options menu, read or write allowed:
  1308.  
  1309.         Symbol name     Default value
  1310.         -----------     ---------------------------------
  1311.         NORMAL          Value of normal display color
  1312.         HILITE          Value of hitlited display color
  1313.         LINES           Number of printed ilnes per page
  1314.         H               Retrace test option, Y or N
  1315.         K               Email KEEP option, Y or N
  1316.         M               Skip RM option, Y or N
  1317.         C               Cls each msg option, Y or N
  1318.         B               Disable keyboard option, Y or N
  1319.         F               Printer formfeed option, Y or N
  1320.         S               Sort QS headers option, Y or N
  1321.         T               Slow screen option, Y or N
  1322.         Q               Quiet alarms option, Y or N
  1323.         P               Send logon ^P option, Y or N
  1324. |       U               Suppress sending ^U, Y or N
  1325.         PROMPT          Prompt character, e.g. ^G
  1326.         MOUSE           Allow mouse, Y or N
  1327.         INSERT          Default editor insert mode, Y or N
  1328.  
  1329.    %SW Command line variables
  1330.  
  1331. |       Each command optional switch can be referenced or changed.
  1332. |       The variable name is of the form:  %SWx
  1333. |       represents the value of the /x switch, Y if on, N if off.
  1334.  
  1335.     where 'x' is one of the following:
  1336.         B            /B  suppress console input, Batch mode
  1337.         C            /C  clear screen each message
  1338. |       D            /D  connect status
  1339.         E            /E  debug, print error messages
  1340.         F            /F  Print TOF
  1341.         I            /I  allow mouse as Input
  1342.         J            /J  default editor to input status
  1343.         M            /M  send RM if appropriate
  1344.         N            /N  No prompt at disconnect
  1345.         O            /O  use Old B protocol
  1346.         P            /P  send ^P at logon
  1347.         Q            /Q  Quiet (no beeps) operation
  1348.         S            /S  have AUTO Sort QS headers prior to marking
  1349.         T            /T  don't use direct screen writes
  1350.         U            /U  suppress command ^U prefixing
  1351.         V            /V  menu mode or command mode (terse)
  1352.         Y            /Y  bypass logon messages, quick logon
  1353.         4            /4  use 43-line mode if available
  1354.         Z            /Z  exit to DOS after logoff
  1355.  
  1356.  
  1357.  
  1358. Page  21                                                 AUTOSIG User's Manual
  1359. II.  ATOSCR - Script File Processing
  1360. ______________________________________________________________________________
  1361.  
  1362.  Global symbols
  1363.  
  1364.  
  1365.    Other global variables
  1366.         Symbol name     Default value
  1367.         -----------     -----------------------------------------
  1368.         %COM            current contents of communications buffer
  1369.                         since the last READ, WAIT, or MATCH
  1370.  
  1371.         %EOF1 thru %EOF9
  1372.                         the current end-of-file status for OPENed
  1373.                         files. If end-of-file has occurred, the
  1374.                         %EOFn value is the character string EOF.
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417. AUTOSIG User's Manual                                                 Page  22
  1418. III. ACLS - Accounting Log Summary
  1419. ______________________________________________________________________________
  1420.  
  1421.  Log Files
  1422.  
  1423.  
  1424.     There is one other set of files created and maintained by AUTOSIG.  They
  1425.     are the  AUTOSIG.mmm Log  files.  The  'mmm' is  an abbreviation for the
  1426.     current  month.   The  Log  files  contain  a  record  of  your  time on
  1427.     Compuserve.  There is one record in the file for every access to CIS  by
  1428.     ATO. Each record contains the following:
  1429.  
  1430.            Date,Baud,Time-on,Time-off,Elapsed-time,Sig-name[flag]
  1431.  
  1432.  
  1433.     The file can be displayed with  the TYPE command, or other text  display
  1434.     programs such as LIST.
  1435.  
  1436.  
  1437.     The [flag] code indicates the condition in which you exited the SIG. "+"
  1438.     means that the AUTO option was  in use; "*" indicates that you  selected
  1439.     the "Stay Connected" option;  no flag means that  this was the only  SIG
  1440.     accessed, or that this was the last  in a series.
  1441.  
  1442.  
  1443.     A minus "-"  next to the  elapsed time field  means that you  uploaded a
  1444.     file and you will receive a credit for the time used.
  1445.  
  1446.  
  1447.     If you are  using the multiple  SIG feature (the  stay connected option)
  1448.     there  is  a  possibility  that  the  SIG  name  for each session may be
  1449.     incorrect  depending  on  what  functions  are performed.  Once you take
  1450.     control of the program, the log file will charge all online time to  the
  1451.     last SIG you accessed.
  1452.  
  1453.  
  1454.     If you  like to  keep detailed  records of  SIG usage,  continue to keep
  1455.     manual records even  if you don't  use the multiple  SIG feature.  There
  1456.     will always  be minor  differences in  the AUTOSIG.log  and your  manual
  1457.     records, so keep this in mind.   Also, remember that the log file  keeps
  1458.     records of your time online to  the tenth of a minute, while  CIS rounds
  1459.     each logon up to the next minute.  This is one reason why AUTOSIG's AUTO
  1460.     and Stay Connected  options can be  much more economical,  since the CIS
  1461.     rounding up doesn't take place until you log off.
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476. Page  23                                                 AUTOSIG User's Manual
  1477. III. ACLS - Accounting Log Summary
  1478. ______________________________________________________________________________
  1479.  
  1480.  Running ACLS
  1481.  
  1482.  
  1483.     There is a companion program to AUTOSIG called ACLS which can be used to
  1484.     get a report of your CIS activity.  ACLS can be run alone or from within
  1485.     ATO.  ACLS  offers  several  ways  of  reading summaries of your connect
  1486.     charges.
  1487.  
  1488.  
  1489.     In ATO, note  the dollar sign  "$" next to  "X" on the  main menu.  When
  1490.     you've finished your sessions with AUTOSIG, you can enter "$" instead of
  1491.     "X" to run the ACLS program rather than exit to DOS. You can also select
  1492.     this  option  in  the  middle  of  an  AUTOSIG  session  to  get a quick
  1493.     accounting, as ACLS  provides the option  of returning back  to AUTOSIG.
  1494.     ACLS  assumes  that  the  ATO  program  file  is named "ATO.EXE" and not
  1495.     "AUTOSIG.EXE". You can tell ACLS the actual program name by supplying a
  1496.     SET parameter for the variable ATO-NAM. For example, if your ATO program
  1497.     file is called ATOTEST.EXE, you would enter the DOS command:
  1498.  
  1499.                     SET ATO-NAM=ATOTEST.EXE
  1500.  
  1501.     before running  ATO or  ACLS.  The  ATO program  file should  be in  the
  1502.     current directory, but, if  ACLS can not find  it, you will be  asked to
  1503.     supply the drive, path, and file name for ATO.EXE.
  1504.  
  1505.  
  1506.  
  1507.     ACLS  requires  a  file  called  RATES.ATO.   This  file  contains   the
  1508.     information necessary to compute online charges based on the day of  the
  1509.     week, time of day, and the  baud rate used.  A sample RATES.ATO  file is
  1510.     provided.  Additionally,  the communications  surcharge, if  any, can be
  1511.     supplied through the SET variable called ATO-CS, for example
  1512.  
  1513.                     SET ATO-CS=0.25
  1514.  
  1515.  
  1516.     When using ACLS remember that it calculates an approximate cost  usually
  1517.     on the high side.
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535. AUTOSIG User's Manual                                                 Page  24
  1536. III. ACLS - Accounting Log Summary
  1537. ______________________________________________________________________________
  1538.  
  1539.  Running ACLS
  1540.  
  1541.  
  1542.  Figure 1.  ACLS Accounting Summary
  1543.  
  1544.    ACLS Selection Menu
  1545.  
  1546. +-------------------------------------+--------------------------------------+
  1547. |                                     |    Summary Report Option Keys        |
  1548. |              A C L S                +--------------------------------------+
  1549. |                                     |     M    Month to date               |
  1550. |     A Usage Log Summary Utility     |     D    Today only                  |
  1551. |            for AUTOSIG              |     O    Other month or file         |
  1552. |                                     |                                      |
  1553. |            Version 3.11             |     R    Rates and definitions       |
  1554. |            March 22, 1990           |     A    Restart AUTOSIG             |
  1555. |                                     |     X    Exit to system              |
  1556. +-------------------------------------+--------------------------------------+
  1557. |              ATOCREW                |    Select one >_<                    |
  1558. +-------------------------------------+--------------------------------------+
  1559.  
  1560. ______________________________________________________________________________
  1561.  
  1562.  Figure 2.  RATES.ATO sample data
  1563.  
  1564. 6
  1565. 6
  1566. 12.5
  1567. 12.5
  1568. 12.5
  1569. 12.5
  1570. .25
  1571. .25
  1572. 08:00:00
  1573. 18:00:00
  1574.  
  1575. ______________________________________________________________________________
  1576.  
  1577.  Figure 3.  ACLS Rates and Definitions
  1578.  
  1579. Here are the rates currently assumed:
  1580.  
  1581.  
  1582. Service    300/450 baud        1200/2400 baud        Comm surcharge
  1583. --------   ------------        --------------        --------------
  1584. Standard      $6.00/hr           $12.50/hr            $0.25/hr
  1585. Prime         $6.00/hr           $12.50/hr            $0.25/hr
  1586.  
  1587. Prime service:    08:00:00 to 18:00:00, Monday thru Friday.
  1588.  
  1589. Standard service: All other times.
  1590.  
  1591.  
  1592.  
  1593.  
  1594. Page  25                                                 AUTOSIG User's Manual
  1595. III. ACLS - Accounting Log Summary
  1596. ______________________________________________________________________________
  1597.  
  1598.  Figure 4.  ACLS Sample Output
  1599.  
  1600.  
  1601. ACLS v3.11                                                    01-26-1990  15:36
  1602.  
  1603.                          AUTOSIG.JAN Since 01-01-1990
  1604.  
  1605.        Rec   300 Std   300 Prm  1200 Std   1200 Prm 2400 Std  2400 Prm
  1606. Forum  ord   min chg   min chg   min chg   min chg  min chg   min chg    Total
  1607. ------ ---  --------  --------  --------  --------  --------  -------   --------
  1608. *other 147                                          45  10.0  24   5.0     15.00
  1609. Email   82                                          49  10.0  35   7.0     17.00
  1610. IbmSys 109                                          89  19.0 137  29.0     48.00
  1611. IBMSys-  1                                                    -4  -1.0     -1.00
  1612. IBMjr   63                                          17   4.0   5   1.0      5.00
  1613. IbmCom 155                                         286  61.0 192  41.0    102.00
  1614. IbmCom- 20                                         -46 -10.0              -10.00
  1615. IbmHw   99                                          25   5.0  43   9.0     14.00
  1616. IbmNew  97                                          19   4.0  19   4.0      8.00
  1617. ------ ---  --------  --------  --------  --------  --------  -------   --------
  1618.  
  1619. Total  773                                         484 133.0 619  95.0    $198.00
  1620.  
  1621. Press ESC to exit, or any other key to continue:
  1622.  
  1623.  
  1624.  
  1625.         Notes:
  1626.                   The *other values represent connect time that can not
  1627.                   be attributed to a specific Forum due to the rounding
  1628.                   up of connect time to whole minutes.
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653. AUTOSIG User's Manual                                                 Page  26
  1654.  Appendices
  1655. ______________________________________________________________________________
  1656.  
  1657.  
  1658.  Disclaimer
  1659.  
  1660.     IBM,  Tandy,  Microsoft,  QuickBasic  and  Compaq  are  all   registered
  1661.     trademarks.  If we missed any our apologies.
  1662.  
  1663.     This program is, of course, offered  as is.  We can't guarentee it  will
  1664.     work on every permutation of  equipment.  We will make an  honest effort
  1665.     to correct and/or add any features that you ask for.
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  Copying and sharing AUTOSIG.
  1672.  
  1673.         AUTOSIG is  a FREE  program available  to all  for the  downloading.
  1674.         In general there are very few "rules" regarding it's distribution:
  1675.  
  1676.          o  No fee may be charged over and beyond the normal fee for
  1677.             materials.
  1678.  
  1679.          o  AUTOSIG may not be distributed by commercial companies
  1680.             engaged in the selling of public domain software.
  1681.  
  1682.          o  AUTOSIG may not be used for commercial ventures.  If you're
  1683.             a company and would like to use AUTOSIG please contact the
  1684.             authors with your pitch (Easyplex preferred).
  1685.  
  1686.          o  The program may not be distributed without this manual,
  1687.             please!
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712. Page  27                                                 AUTOSIG User's Manual
  1713.  Appendices
  1714. ______________________________________________________________________________
  1715.  
  1716.  Using Virtual Disks
  1717.  
  1718.  
  1719.     The following code can be used as an AUTOEXEC.BAT file for ATO.EXE  when
  1720.     used in conjunction  with RAMDSK or  other programs that  use RAM and  a
  1721.     phantom drive.  In this file, the assumptions are:
  1722.  
  1723.            o Two floppy disk drives (A & B)
  1724.            o AUTOSIG.EXE, AUTOSIG.DFN and AUTOSIG.MTH (.JAN, .FEB,
  1725.              etc.) residenton drive A:
  1726.            o RAMDSK is part of the CONFIG.SYS file and configured as
  1727.              drive C:
  1728.            o A resident clock.  If not, replace the REM at line 3 with
  1729.              'Date'and insert a new line below it:  'Time'
  1730.            o AUTOSIG.EXE has been renamed ATO.EXE
  1731.  
  1732.     In the unlikely event  of a crash, your  .DFN file is preserved.   Go to
  1733.     drive A: and  COPY DFN.BKP AUTOSIG.DFN.   Otherwise, this file  puts all
  1734.     files into RAMDSK  and eliminates any  disk-spinning from log  on to log
  1735.     off.
  1736.  
  1737.       cls
  1738.       echo off
  1739.       REM insert screen blanking program here
  1740.       copy AUTOSIG.DFN c:
  1741.       erase DFN.bkp
  1742.       ren AUTOSIG.DFN DFN.bkp
  1743.       ren AUTOSIG.exe temp.exe
  1744.       copy AUTOSIG.* c:
  1745.       ren temp.exe AUTOSIG.exe
  1746.       copy batch.ato c:
  1747.       b:
  1748.       copy *.ato c:
  1749.       copy *.fil c:
  1750.       a:
  1751.       AUTOSIG /p c: /f
  1752.       REM drive ("c:") above should be one letter higher than your highest
  1753.       REM "/p" and "/f" are optional flags
  1754.       b:
  1755.       erase *.ato
  1756.       c:
  1757.       copy AUTOSIG.* a:
  1758.       copy batch.ato a:
  1759.       erase AUTOSIG.*
  1760.       erase batch.ato
  1761.       copy *.* b:
  1762.       erase *.fil
  1763.       erase *.ato
  1764.       a:|cls
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771. AUTOSIG User's Manual                                                 Page  28
  1772. Index-1                                  AUTOSIG Advanced Functions Guide
  1773. __________________________________________________________________________
  1774.  
  1775.  
  1776.  
  1777.   "$",ATO invoking ACLS ........ 24
  1778.   %COM ......................... 7, 9, 10, 14, 15, 22
  1779.   %EOF ......................... 9
  1780.   %HOST variables .............. 20
  1781.   %PC variables ................ 21
  1782.   %SIG variables ............... 20
  1783.   %SW Command line variables ... 21
  1784.   /X,ATO command line option ... 7, 21
  1785.   A  Add manual entry .......... 4
  1786.   ACLS ......................... 24, 25, 26
  1787.   ACLS Selection Menu .......... 25
  1788.   Alt-I,insert PPN ............. 4, 7
  1789.   Alt-M,invoke ATOPPN .......... 2
  1790.   Alt-T,execute SCRipt ......... 7, 19
  1791.   ATO-CS,SET variable .......... 24
  1792.   ATO-NAM,SET variable ......... 24
  1793.   ATOPPN ....................... 2, 3, 4, 6
  1794.   ATOPPN Menu .................. 3
  1795.   B  Switch PPN database file .. 4
  1796.   C  Change current entry ...... 4
  1797.   Copying and sharing AUTOSIG. . 27
  1798.   D  Delete current entry ...... 4
  1799.   DATAPAC,script ............... 17
  1800.   Disclaimer ................... 27
  1801.   E  Erase PPN file ............ 4
  1802.   ESCape ....................... 2, 3, 7, 10
  1803.   Execute a script ............. 7
  1804.   F  Find name or userid ....... 4
  1805.   Global,variables ............. 7, 8, 9, 11, 15, 20, 22
  1806.   L  sort by Last name ......... 5
  1807.   M  Switch message file ....... 5
  1808.   N  sort by Name .............. 5
  1809.   P  Put entry to TO: field .... 5
  1810.   Q  Quit, return to ATO ....... 6
  1811.   R  Repeat Find to next ....... 5
  1812.   RATES.ATO,ACLS file .......... 24, 25
  1813.   S  Sort by userid/ppn ........ 5
  1814.   Set up,new ATO forums ........ 19
  1815.   Sort by,for PPN order ........ 3, 5
  1816.   Sort, %SWF option ............ 21
  1817.   Telenet,script ............... 16
  1818.   Tymnet,script ................ 15, 20
  1819.   U  Update file from msgs ..... 6
  1820.  
  1821.  
  1822.